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まえ みがき 

API に アク セス する こと を 一 般 的 に 「API を 叩く 」 と 表現 し ます 。 本 書 は 艦 こ れ の API を 叩き 、 ど の よう に ゲー ム が 進行 し 
て いる か 解説 し ます 。 

な ん て の は 嘘 で す 。 この 本 の タイ トル の 「 艦 これ の API を 叩く 」 は アク セス する と いう 意味 で は あり ませ ん 。 


世間 一 般 で 「XX を 叩く 」 と いえ ば 、「XX を 非難 する 」 と いう 意味 の 比 吸 表現 で す 。 この 本 も 、 人 類 史 上 稀 に 見 る 「 ク ソ 
API」 で ある 艦 こ れ の API を 「 非 難 」 し 、 艦 こ れ API を 悪い API の 題材 と し 、 よ り よ い API 設 計 を 解説 する こと を 目的 と し て 
いま す 。 


な お 、 著 者 は 2013 年 の 10 月 初旬 に BAN さ れ て 、 抜け 道 * も 2014 年 2 月 初旬 に 閉じ られ て し まい 、 

現在 は 既に プレ イ で き な い の で 、 書 か れ た API が その まま 実行 で きる 保証 は あり ませ ん 。 

特に 4 月 頃 に 大 幅 に API が 変わ っ た と いう 話 が ある の で 、 今 は 少し は 改善 され て いる の か も 知れ ませ ん 。 

本 書 の 内 容 は 2074 年 7 月 末日 時 点 の API を 元 に 書か れ て いま す 。 艦 こ れ API や DMM ゲ ー ム の 仕様 に 関し て は 、 通 信 内 容 や 
html や javascript を 読ん で 推測 し た も の で あり 、 内 部 の 動作 が 実際 に そう で ある と いう こと は 保証 で きま せん 。 な お 、 過 


去 の API に 対応 し た 自動 化 シ ステ ム ( 以 下 riN4s ) を Github で 公開 し て いま す 。 


+. BAN さ れ た の に 抜け 道 が あっ て 半年 閉じ られ な か っ た と いう クソ API 


ログ イン 
この 章 で は 艦 こ れ に ログ イン する まで の や り と り を 解説 し ます 。 
DMM に アク セス し て アプ リ を 起動 する 


ゲー ム を 始め る た め に 、DMM に アク セス し て 艦 こ れ を 起動 し ます 。 


DMM の オン ライ ン ゲ ー ム は 、 他 の 多く の SNS 上 の ソー シャ ル ゲ ー ム と 同様 に 、 DMM が 用 意 す る 共通 レイ アウ ト の 中 に 、 
ゲー ム プ ロバ イダ か ら 指 定 さ れ た gaqget.xmtu と いう ファ イル の 内 容 に 従っ て 、 iframe で ゲー ム 本 体 を 読み 込む 仕組 み に 
な っ て いま す 。 


DMM の 内 部 で は 、 ア プリ の キー や シー クレ ッ ト と 共に 、 gadqget.xmt へ の URL が 登録 され て いる と 推測 され ます 。 アプ リ 
起動 に 必要 な 情報 は 全て DMM が 持っ て いる の で 、 簡 単に 攻撃 は で きま せん 。 


アプ リ 起 動 中 に 攻撃 で きる 人 


艦 こ れ の gadget.xmt は 、http で 配信 され て いま す 。 gadget.xmnu に アク セス する クラ イア ント は DMM サ ー バ な の で 、http 
で も 外部 か ら の 攻撃 に は 耐性 が あり ます 。 た だ し 、DMM の サー バ と 艦 こ れ の サー バ を 繋ぐ 経路 上 に いる 機器 を 攻撃 で き 
た 場合 、 ニセ の gadqget.xmt を 配信 する こと が で きる の で Man in the Middle 攻撃 (以下 MitM 攻 撃 ) が 成立 し ます 。 プロ バ 
イダ の 中 の 人 と か じゃ な いと で き な い と 思い ます 。 


和 監 こ れ サ ー バ に ユー ザ 認 証 


iframe に 艦 これ 本 体 が 読み 込ま れる と 、 艦 これ サー バ ヘ ログ イン 認証 が 行わ れ ま す 。 まず javascript で DMM サ ー バ に ア 
クセ ス し て いる ユー ザ の 情報 を 取り に 行き ます 。 DMM の ユー ザ ID が 取得 で きる と 、 艦 これ サー バ に 接続 し 、 所 属す る 鎮 
守 府 を 取得 し 、 ロ グイ ン API を 叩き ます 。 


ログ イン API が 成功 する と 、 レス ポン ス に は api_token と api_starttime と いう 2 つの 情報 が 含ま れ て いて 、 この 2 つの 情報 
を パラ メー タ に し て flash を 読み 込み 、 ゲ ー ム が 始ま り ま す 。 ちな み に rjNh4as で は 、 こ の flash を 読み 込む 瞬間 を Chrome 

Extension で フッ ク ) し 、 ロー カル に 立て た サー バ に トー クン を 送信 し て 、 認 証 情報 を 外 の 世界 に 送る ~ と いう 工夫 を し て 

いま す 。 


ユー ザ が BAN さ れ て いる 場合 、 ロ グイ ン API は 特殊 な レス ポン ス を 返し 、 クラ イア ント は @{banned} の よう な 画面 を 表示 
紅 ま 浅 。 


INMMMI.com 。 人) オン ライ ン ゲ ー ム トッ プ 区 り DMM ポ イン ト : 確認 す る  (P) ポイ ント 購入 ) 初め て の 方 


本 アカ ウン ト ID は 、 現在 停止 措置 され て いま す 。 


し 対応 環境 (③④) お 問い 合わ せ 


オン ライ ン ゲ ー ム 利用 規約 | 特定 商取引 法 に 基づく 表示 
Copyright @ since 1998 DMM All Rights Reserved. 


トー クン の 仕組 み 


後述 する API は 全て 、 こ の api_token と api_starttime を 利用 し て リク エス ト し ます 。 この api_token か ら 艦 これ サー バ で 
ユー ザ を 特定 し 、 api_starttime で 正しい リク エス ト か 検証 し て いる よう で す 。 逆 に 言う と この パラ メー タ さ え 知 っ て い 
れ ば 、 他 の ユー ザ に 成り すま すこ と が 可能 で す 。 この パラ メー タ は 艦 こ れ の ユー ザ 認 証 を 行う た びに 新しい 値 が 払い 出さ 
れ ま す 。 イメ ー ジ と し て OAuth の アク セス トー クン に 近い も の が あり ます 。 


ユー ザ 認 証 中 に 攻撃 で きる 人 


ほぼ すべ て の 人 が 攻撃 で きま す 。 この 認証 シス テム に は た くさ ん の 問題 が あり ます 。 
HTTP 通 信 


サー バ 間 通信 で は それ ほど 問題 に な は り ま せん が 、 今回 は javascriprti に より ユー ザ の ブラ ウザ と 艦 こ れ サ ー バ が ログ イン の 通 
信 を 行い ます 。 MitM 攻 撃 で ログ イン の 通信 を 覗か れ た 場合 、 攻撃 者 は 簡単 に トー クン を 取得 で きる の で 何で も や り 放 題 
で す 。 


ユー ザ と サー バ 間 の MitM 攻 撃 は 圧倒 的 に 簡単 に 実現 可能 で す 。 パケ ッ ト キ ャ プチ ャ を 仕込 ん だ WiFi ア クセ スポ イン ト を 設 
置 す れ ば いい だ け で す 。 外 で も 艦 こ れ す る た め に Windows タ ブレ ッ ト が バカ 売れ らし いで す が 、 パス ワー ド が か か っ て 
な い 野 良 WiFi を 見 つけ て 、 し めし め な ん て 思っ て 繋い で し まう と 、 通信 内 容 が 全て 覗か れ て いる 可能 性 が あり ます 。 そ 
の 場合 api_token が 抜か れ て し まう の で あら ゆる API が 叩か れ て し まい ます 。 


生存 期間 


どう や ら 艦 これ の ユー ザ 認 証 を 行っ て 新しい トー クン を 取得 し な い 限 り 、 ト ー ク ン は 無限 に 生き 続け る よう で す 。 BAN さ 
れ て いて も 約 半 年 間 ゲ ー ム が で きた の は 、 こ の トー クン を 自分 の コン ピュ ー タ の デー タベース が 覚え て いた か ら で 、 覚 え 
て いた トー クン を パラ メー タ に し て flash を 直接 リク エス ト す れ ば 問題 な く ゲ ー ム が で きま し た 。 BAN が 完全 に 有効 に 


な っ た 理由 は 明らか で は な いで す が 、 少 な く と も 半年 の 生存 期間 が ある よう で し た 。 
BAN の 判定 タイ ミン グ 


BAN の 判定 は ログ イン 時 の み 行 われ 、 新 し い ト ー ク ン が 取得 で き な い と いう 制限 し か あり ませ ん 。 以前 に 取得 し た 生き て 
いる トー クン さえ 知っ て いれ ば BAN が 有効 に な り ま せん 。 逆 に 新しい トー クン が 取得 で き な い こと で 、 生 き て いる トー ク 
ン が 特定 し や すい と 言っ て も 過言 で は な いで す 。 全て の API ア クセ ス 時 に サー バ で ユー ザ の BAN 判 定 を する べき で す 。 ど 
う せ トー クン か ら ユ ー ザ を 特定 する 作業 は し て いる は ず な の で 負荷 は 増え ませ ん 。 


まとめ : API 改 善 ガ イド 


e 当たり 前 だ けど 全部 HTTPS に する 

s トー クン の 生存 期間 を 十分 短い 時 間 に 設定 する 

e リク エス ト 毎 に トー クン を 作り な お す / 取 得 し 直す 

s リク エス ト 毎 に サー バ 側 で BAN の 判定 を する 

e キー が 2 つ あ る の は そん な に 意味 が な い api_starttime は 不要 


特に トー クン を 毎回 作り な お す の は 非常 に 効果 が あり ます 。 API レ スポ ンス に 次 の トー クン を 含め る と か で いい と 思い ま 

す 。 攻撃 者 が 一 度 ト ー ク ン を 取得 し た ら ず っ と 覗き 続け られ る こと が 現状 の 実装 の 一 番 マ ズ い 部 分 で し ょ う 。 毎回 トー ク 
ン が 変わ れ ば 、 攻 撃 者 が 1 回 API レ スポ ンス を 見 逃し た だ け で 続き が 見 れ な く な り ま す 。 他 の 効果 と し て 、 riN4s を 動か 

し な が ら 普 通 に ゲー ム を プレ イ す る の が か な り 難 し く な り ま す 。 


た だ し API リ クエ スト の 並列 化 が で き な く な る の で 大 き な 問 題 に な り ま す 。 現実 的 な 解 と し て は 、 ト ー ク ン の 生存 期間 を 
十分 短く し 、 頻 繁 に トー クン 更新 を させ る こと で し ょ う 。 


+. こ の 部 分 が 一 番 独創 的 な 部 分 だ と 思っ て ます の 


API 概 略 


この 章 で は 艦 こ れ の API の リク エス ト と レス ポン ス の 共通 部 分 を 解説 し ます 。 
リク エス ト 


ア 自 トヨ ル 

全て http で す 。 あら ゆる も の が 丸見え で す 。 

MitM で 認証 情報 を 取得 し た 攻撃 者 は 、 全 て の API を 実行 可能 で す 。 

HTTP メソ ッ ド 

全て の API リ クエ スト が posr メソ ッ ド を 使っ て いま す 。 posr メソ ッ ド は 、 リ ソー ス の 作成 に 使わ れる べき メソ ッ ド 


で 、 例え ば 艦 娘 の デー タ を 取得 する と いう API は 、 艦 娘 と いう リソー ス に 変化 が 起こ ら な い の で 、 eEr を 使う べき で す 
が 、 全て posr が 使わ れ て いま す 。 


認証 
ログ イン の 際 に 渡さ れ た api_token を パラ メー タ に 追加 し て ユー ザ 特 定 を 行い ます 。 実は これ だ け で は な く 、 Referer 


ヘッ ダー に flash の url を 設定 する 必要 が あり 、 その url に は api_token と api_starttimne の パラ メー タ が 付け られ て いま 
天 。 


その 他 


origin ヘッ ダー に API サ ー バ の ドメイン 、 Accept-Encoding に gzip, def1ate, sdch の 指定 が 必須 で し た 。 
らく 
レス ボン ス 


形式 


レス ポン ス は 全て JSON で す 。 正確 に 言う と 、 
svdata={JSON 文 字 列 } 


と いう 、 eva1 で 評価 する と 変数 svaata に JSON の デー タ が 格納 され る javascript の コー ド で す 。 た ぶん svaata は 
グロ ー バ ル 変 数 で 、API の レス ポン ス に 対す る 処理 は 1 つの グロ ー バ ル 変 数 を 共有 し て いる の で は な いか と 思い ます 。 


交 字 ヨー ド 
文字 コー ド は UTF-8 で 統一 され て いま す が 、API の モノ に よっ て は な ぜ か BOM 付 き UTF-8 に な っ て いま し た 。 レス ポン ス 
を 出力 し て も BOM は 目 に 見 えな い の で 、JSON を 取得 する た め の s/^svdqata=// が 上 手 く 動か な い 理由 に 気づき に くく 、 


非常 に 還 り まし た 。 も し わざ と や っ て いる な ら な か な か 優秀 な 罠 で す 。 


ソー スコ ー ド の 保存 時 に 起き た 問題 と 考え られ 、 開 発 者 の エディ タ や その 設定 が 共通 化 さ れ て いな いこ と が 想像 で きま 
す 。 また 、 フ ァイル の 先頭 バイ ト が レス ポン ス に その まま 出力 され て いる と いう 特徴 か ら 、 サー バ の 言語 は php で は な 
いか < と 予想 し て いま す 。 


ステ デー タス ヨー ド 


API レ スポ ンス の ステ ー タ スコ ー ド は 全て 2ee ok で す 。 2ee oc は リク エス ト が 成功 し た こと を 表す ステ ー タ スコ ー ド で 
あり 、 不正 な リク エス ト や 内 部 エラ ー な ど で リ クエ スト が 正しく 処理 で き な い 場合 は 、 2ee oc で は な く ふ さわ し い ス 
テー タス コー ド を 返す べき で す 。 


ステ ー タ スコ ー ド の 代わ り に 、JSON 内 に api_resuut と いう 情報 が あり 、 こ の 値 が + の 場合 は API は 成功 し た と みな さ 
れ ま す 。 不正 な リク エス ト や 内 部 エラ ー な ど で リ クエ スト が 成功 し な か っ た 場合 、 api_resuut は 1 以外 の 値 に な り 、 
この と き flash ク ライ アン ト は 猫 画面 を 表示 し ます 。 


===[column] ね この ひみ つ API リ クエ スト の 失敗 理由 が (た ぶん ) 高 負荷 の 場合 な ど は 、 同じ リク エス ト を 続け て 送る と 普 
通 に 成功 する こと が あり ます 。 し か し flash ク ライ アン ト は それ を 一 切 す る こと な く 、 た だ 闇雲 に リロ ー ド し ろ と 迫っ て く 
る の で す 。 艦 これ 最大 の 敵 と 言わ れる 妖怪 猫 吊 る し は この よう な 仕組 み で 提督 の 精神 を 削っ て いく の で す 。 


JSON デー タ 


API レ スポ ンス の 主要 な デー タ は 、 api_data と いう キー の 中 に 入っ て いま す 。 大 雑 把 に 書く と この よう な デー タ に な っ て 
いま す 。 Github に は 大 量 の レス ポン ス の サン プル が あり ます 


{"api_result": 1, 
"ap1_data": { 
apa 汗 eoumtl: 財 15 
"aD1_Dade_count": 3, 
ap JeE 
で ルル 
で 


]。 
+ 
+ 


な ぜ か 全て の キー に spi_ と いう 接頭 詞 が 付け られ て お り 非 常に デー タ サ イズ が 無駄 で す 。 レス ポン ス の デー タ サ イズ は 
その まま 通信 量 の サイ ズ に な り 、 現代 の コン ピュ ー タ 環境 で は 通信 スピ ー ド が 一 番 の ボトル ネッ ク な の で 、 すなわち どれ 
くら い の リ クエ スト を 処理 で きる か と いう 話 に な り ま す 。 試し に いく つか の レス ポン ス か ら sapi_ の 文字 を 抜い て みた 
ら 、 デ ー タ サイ ズ が 約 2 割 削減 で きま し た 。 単純 に ap:_ を 抜く だ け で 、 通 信 コ スト や 同時 アク セス 数 、flash の 負荷 が 約 2 
割 ほど 改善 され る と いう こと で す 。 


まとめ : API 改 善 ガ イド 


e HTTPS を 使う 

e HTTP メ ソ ッ ド と ステ ー タ スコ ー ド を 正しく 使う 

e BOM 付 き UTF-8 や svqatas は コー ド か ら お 里 が 知れ る か ら 削 除 す る 
e デー タ 削 減 を 意識 し て レス ポン ス の 構造 を 最適 化す る 


Google 先 生 が 1 バイ ト を 削る の に 心 皿 を 注い で いる よう に 、 レス ポン ス を 1 バイ ト 削 る こと は 積み 重なっ て 大 き な 改 善 に 
な り ま す 。 個別 の レス ポン ス を 見 て いく と 、 酷 い デ ー タ 構造 も た くさ ん あり 、 デー タ 量 の 削減 を 意識 し て デー タ 構 造 を 再 
設計 する と か な り 人 負荷 は 改善 され る と 思い ます 。 


+.<?2php の 前 に BOM の バイ ト 列 が 書か れ て いる こと に な る の 


2 テン プレ ー ト に 紛れ 込ん で いる 可能 性 も ある が JSON を 個別 に テン プレ ー ト ファ イル に 書く と は 思え な い 


デー タ 取 得 API 


この 章 で は 艦 こ れ を 構成 する 様々 な デー タ が どの よう に 配信 され る の か 解説 し ます 。 


2 種類 の デー タ 


デー タ に は 大 きく 分 け て 2 つの 種類 が あり ます 。 マス タデ ー タ と ユー ザ デ ー タ で す 。 
マス タデ ー タ は 基本 的 に ログ イン 時 に まとめ て 取得 し 、 ユー ザ デ ー タ は 行動 ご と に 必要 な も の を 取得 し ます 。 


ログ イン 時 に ロー ド で 長 時 間 待た され る の は 、 大 量 の マス タデ ー タ を 取得 する た め だ と いえ ます 。 


マス タデ ー タ 


マス タデ ー タ の API は 全て /kcsapi/api_get_master/ と いう URL の 下 に あり ます 。 ログ イン 時 に 艦 種 、 艦 娘 デ ー タ 、 装 備 、 
家具 な どの 固定 デー タ を ひと 通り 取得 し ます 。 例外 は マッ プ に 関す る マス タデ ー タ で 、 こ れ は 出撃 の た びに 取得 され ま 
天 。 


例え ば 艦 種 デー タ を 見 て みる と id=1 が 海防 勝 だ っ た り 、 戦 艦 が 2 種類 あっ た り 、 な か な か 不思議 な も の を 見 た 気 に な り ま 
天 。 


艦 娘 マス タデ ー タ 


艦 娘 の マス タデ ー タ は 、 約 50KB あ る 巨大 な デー タ で す 。 この デー タ に は や は り 不 要 な デー タ が た くさ ん 入っ て いま す 。 
初期 の デー タ は な る べく 小さ く 、 必 要 に な っ た 時 点 で 他 の デー タ を 取っ て くる 設計 に する と か な り 小 さく な る は ず で す 。 


例え ば 、 全 員 分 の ドロ ッ プ 時 の メッ セー ジ ` が 含ま れ て いま す 。 回 数 的 に 考え る と 、 戦 闘 終了 時 の API レ スポ ンス に 毎回 含 
め た ほう が 全体 の サイ ズ は 小さ く な る と 思い ます 。 


他 に も 図鑑 で 使う た めか 能力 の 初期 値 が 全員 分 含ま れ て いま す が 、 こ れ も 図 鑑 に アク セス し た 瞬間 に 取得 する べき で す 。 
一 回 の ログ イン で 一 度 も 図鑑 に アク セス し な い 人 の ほう が 多分 多い ん だ か ら 。 


ーー F デ ー タ 


ユー ザ デ ー タ の API は 全て /kcsapi/api_get_member/ と いう URL の 下 に あり ます 。 所 持 し て いる 艦 娘 、 装 備 、 家 具 や 艦隊 の 
情報 、 レ ベル や 資材 の 数 な ど が 取得 で きま す 。 


艦 娘 デ ー タ 


所 持 し て いる 艦 娘 が 全て 詰まっ た デー タ で す 。 1 ペー ジ に 表示 され る の は た か だ か 20 件 くら い だ っ た と 記憶 し て いま す 
が 、 そ れ で も 全 件 取得 し ます 。 これ を 提 削 の 部 屋 に 戻る た びに 毎回 取得 し に 行き ます 。 


艦隊 編成 画面 の ソソ ー ト 順 を グロ ー バ ル に 持っ て いて 、 そ の 順 で ソー ト さ れ た レス ポン ス が 返っ て きま す 。 艦隊 編成 画面 で 
ソー ト 順 を 変更 する と 、 全 部 取得 し な お し で す 。 


それ ぞ れ の 艦 の デー タ は 


"ap1_member_1d":32377, 

ap di2 

"ap1_sortno":347, 

"ap1_name": "Nu6dbcNu98a8Nu6539", 
"ap1_yom1": リ Nu3959Nu365aNu364D\Nu305c『, 
"api_stype":2, 


Mapa 寺 Shin 二 NdM2277 

"ap1_1V":77, "ap1_exp":349951, "ap1i_after]v":6, 
"ap1_aftership1d":6, 

"ap1_nowhp":15, "ap1_maxhD":36, 

"ap1_taik":[39,57], "api_souk":[49,49], "ap1_houg":[53,49], ... 


の よう な デー タ に な っ て いて 、 こ れ が 全員 分 配列 で 並ん だ デー タ に な っ て いま す 。 
見 て 解る 6 と お り 、 ship_iq が 指定 され て いる に も 関わ ら ず 、 艦 娘 の マス タデ ー タ を 一 切 使わ ず す べ て 冗長 な デー タ に な っ 


て いま す 。 この 中 で 必要 な デー タ は id, ship_id, 現在 の ステ ー タ ス 値 だ け で ある こと は 容易 に 解り ます 。 ソー ト 順 の 変更 
も 、 ソ ー ト され た id の リス ト で よい は ず で す 。 


武器 デー タ 


も っ と 凶悪 な の が 武器 デー タ で す 。 所 持 し て いる 武器 を 全て 取得 し ます 。 艦 娘 の 数 と は 比べ 物 に な り ま せん 。 デー タ サ 
イズ で お よそ 6 倍 * あ り ま し た 。 武器 を 破棄 が 凄く 遅い の は 、 破 棄 後 に 毎回 この API が 呼ば れる た めで す 。 


艦 娘 と 同じ よう に 全て 冗長 な デー タ に な っ て いま す 。 武器 は 成長 の 要素 が な い の で 、id 何 番 の 武器 を 何 個 持 っ て いる と い 
う レ スポ ンス で 十分 で す 。 た ぶん 現在 の レス ポン ス を 9 割く らい 削減 で きる の で は な いで し ょ うか 。 


初期 化 処理 の 最適 化 サ ンプ ル 


初期 化 処 理 を 最適 化し て み ま し ょ う 。 まず ユー ザ デ ー タ の うち 、 レ ベル や 資材 数 は 現状 の API の まま で よい で し ょ う 。 


ログ イン 直後 に マス タデ ー タ を 取得 する 必要 は あり ませ ん 。 最短 で 提 普 部 屋 の 画面 を 出す た め に 、 秘 書 官 の ID と 内 装 の ID 
リス ト だ け を 返す API を 作り まし ょ う 。 秘書 艦 の ログ イン 時 ボイス や 、 内 装 の 画像 は ID か ら url が 決ま る よう に ルー ル づ け 
し まし ょ う *。 これ だ け で 提 部 屋 の 画面 が 出せ ます 。 た っ た 数 キロ バイ ト で 実現 可能 で す 。 


その 後 お い お い マス タデ ー タ や 他 の ユー ザ デ ー タ を 取得 する よう に し まし ょ う 。 


まとめ : API 改 善 ガ イド 


e と に か く デ ー タ 量 を 減ら す 

es デー タ の 分 割 ・ 差 分 取得 を する 
e 冗長 な デー タ を 店 け 正規 化す る 
e 非同期 通信 を 活用 する 


中 身 の コ ー ド が わか ら な い の で 正確 な と ころ は わか り ま せん が 、 レス ポン ス の svqatas。 は お そら く グ ロー バル 変数 へ の 
代入 の よう な 処理 だ と 想像 し ます 。 つま り 、API の レス ポン ス を 受け 取る と グロ ー バ ル 変 数 が 書き 換え られ る こと に な 
り 、 これ を 上 手 く 制 御 し て 動か す に は 、 通 信 が 逐次 実行 で ある こと が 保証 され て な いと いけ ませ ん 

「 複 数 の リク エス ト を 同時 に 出し 、 返 っ て きた レス ポン ス か ら 処 理 す る 」 と いう 非同期 通信 の 強み が 使え な いこ と に な り 
ます 。 さら に 、 レ スポ ンス を 見 て 新しく リク エス ト を 作る こと も 難し い の で 、「 必 要 な デー タ が な か っ た ら 差 分 取得 」 み 
た いな コー ド も 書き に くい の で は な いで し ょ うか 。 

+ 例 ) 艦隊 の アイ ドル 、 那 珂 ち ゃ ん だ よー。 よ っ ろ し くぅ ~! の 


2. 所持 艦 娘 : 30KB 所 持 装備 : 200KB ” 


3. た ぶん 最初 か ら そ うな っ て る で 


4 逐次 実行 は 理解 し や すい の で 悪い わけ で は な い 特に ゲー ム の 進行 な ど で は 適材 適所 で ある ご 


編成 ・ 補 給 ・ 修 理 ・ 遠 征 


艦隊 の 編成 を 変更 する に は 、 /kcsapi/api_req_hensei/change の API を 叩き ます 。 パラ メー タ は 、 第 api_iq 艦隊 の 
api_ship_idx 番目 を api ship id の 艦 娘 に 変更 する と いう 形式 で す 。 艦 娘 を 外す 場合 に は api_ship id に -+ を 指定 し 
ます 。 


Flash ク ライ アン ト か ら は 1 つの 艦隊 に 同じ 種類 の 艦 娘 を 配置 で き な い よう に な っ て いま す が 、 API で は 何 も 制 限 さ れ て お 
ら ず 、 同 じ 種 類 ど ころ か 全く 同じ ship_id で 6 隻 埋め る こと も 可能 で す 。 今 の と ころ 伊 401 は イベ ント 報酬 の 1 隻 し か 無い は 
ず で す が 、 全 員 伊 401 で 埋め る こと が 可能 と いう こと で す 。 


さら に 、 通 常 変更 で き な い 状況 で も API で は 何 も 制 限 し ませ ん 。 出撃 中 + の 艦隊 で も 遠征 中 の 艦隊 で も 変更 可能 で す 。 


艦隊 に 補給 する に は 、 /kcsapi/api_req_hokyu/charge の API を 叩き ます 。 api_id_items に 補給 する 艦 娘 の id を , で 繋げ 
た 文字 列 を 指定 し ます 。 


編成 と 同様 に 制限 は ほとん ど 無 く 、 出撃 中 の 補給 も 遠征 中 の 補給 も 自由 で す 。 Flash で は 1 ペー ジ ご と に 補給 し な く て は い 
け ま せん が 、API は お そら く 全 艦 一 気 に 補 給 で きま す S。 


修理 


艦 娘 を 修理 する に は 、 /kcsapi/api_req_nyukyo/start の API を 叩き ます 。 パラ メー タ に は api_dock_id と api_ship_id 、 
バケ ツ を 使う 場合 は api_highspeeq を 1 に 設定 し ます 。 途中 で バケ ツ を 使う 場合 は 、 
/kcsapi/api_req_nyukyo/speedcharge の API を 叩き ます 。 


も う 予 想 で きる と 思い ます が 、 修 理 の API に も 制限 は ほとん ど な く 、 出撃 中 で も 遠征 中 で も 修理 で きま す 。 ボス に 到達 し 
た ら 全 艦 娘 に バケ ツ ぶ っ か け て な ん て こと も で き て し まい ます 。 唯一 チェ ッ ク が 入る の は ドッ ク が 使用 済み か どう か と い 
うと ころ だ け で す 。 


問題 点 


API 設 計 の 基本 中 の 基本 で す 。 必 ず サ ー バ 側 で 入力 が 正しい か チェ ッ ク し まし ょ う 。 API の みな ら ず 、web シ ステ ム を 作る 
と き は 必ず サー バ 側 で 入力 値 の チェ ッ ク を し まし ょ う 。 


例え ば htmlI5 に は 入力 値 の チェ ッ ク 機 構 が 入り まし た が 、 あ れ は 単なる 入力 補助 で し か あり ませ ん 。 javascript で 入力 値 の 
チェ ッ ク を し た りす る こと も あり ます が 、 それ も 余計 な HTTPDP リ クエ スト を 減ら し た いと いう 目的 で 使う こと が ほとん ど 
で す 。 その 場合 に も 必ず サー バ 側 で 入力 値 の チェ ッ ク を し まし ょ う 。 


根本 的 な 問題 


そもそも 、 サ ー バ 側 で 入力 値 の チェ ッ ク を し て いな いと いう こと は 、 エン ジニ ア が ある 致命 的 な 状態 に 陥っ て いる こと を 
示し て いま す 。 それ は クラ イア ント プロ グラ ム を 信用 し て いる と いう 間違っ た 思想 で す 。 


Web シ ステ ム を 作る 上 で 、 絶 対 に クラ イア ント を 信用 し て は いけ ませ ん 。 HTTP の 仕様 上 、 何 が 正しい の か 、 何 が 正しく 
な い の か 判断 する こと は で きま せん 。 そもそも 正 ・ 不 正 の 概念 を 定義 する こと すら 不可 能 な ん じゃ な いで し ょ うか 。 全て 
の 通信 は 、 実 行 す る ユー ザ に は 基本 的 に 全て 見 えて し まう し 、 それ を 完全 再現 する こと も 容易 で す 。 な の で 絶対 に クラ イ 


アン ト を 信用 し て は いけ ませ ん 。 


実際 、 rjN4s を 実装 する 時 も 通信 の 内 容 を 解析 し か し て いま せん 。 や っ て いる こと も flash ク ライ アン ト が 出す リク エス 
ト と 同じ も の を 出し て いる だ け で す 。 flash ク ライ アン ト の 逆 ア セン ブル は 多分 規約 で 禁止 され て いる ? と お も いま す が 、 
そん な も の 全く 意味 が な い の で す 。 


さて 、 raN48 と は 何で し ょ うか 2? API を 叩く bot で し ょ うか ? それ と も flasnh の プロ グラ ム を 実行 する 処理 系 で し ょ うか 2? そ 
れ と も ブラ ウザ その も の で し ょ うか ? 運営 の 言う 「 正 し く プ レイ し な いと BAN す る ぞ 」 の 正しい プレ イ と は 何で し ょ うか ? 
本 質 的 に そん な も の 定義 で き な い ん で す よ 。 ネッ トワ ー ク 上 で は 全て の 通信 が 平等 で す 。 そこ に は 正しい と か 正しく な い 
と か 無い の で す 。 


===[column] セキ ュ リ ティ 設計 の は な し 


Web シ ステ ム の 設計 で クラ イア ント を 信用 し て は いけ な いよ うに 、 セキ ュ リ ティ の 設計 を 考え る 時 は 、 絶 対 に 人 間 を 信用 
し て は いけ ませ ん 。 基本 的 に 人 間 は 全員 犯罪 者 で 常に 攻撃 の 機会 を 狙っ て いる と 思わ な けれ ば いけ ませ ん 。 この 「 人 間 」 
に は 、 同僚 や 親 兄弟 は お ろか 自分 自身 も 含み ます 。 エン ジニ ア は 日 々 、 シ ステ ム を 知り 尽く し た 自分 な ら ど ん な 犯罪 を 犯 
すか を 想像 し 、 それ で も 攻撃 で き な い よう 、 あ り と あら ゆる 可能 性 を 潰す 、 と いう 仕事 を し て いま す 。 


そり ゃ 病む に 決ま っ て ん だ ろ ・・・ 
まとめ : API 改 善 ガ イド 


es サー バ で 入力 値 を 全て チェ ッ ク す る 
es クラ イア ント を 信用 し な い 
e 正しい プレ イ な ん か 定義 で き な い 


と は いう も の の 、 正 し い プ レイ を 定義 する 方 法 は 実は 1 す つ だ け あ り ま す 。 それ は 指定 され た 環境 以外 で の 実行 を 許可 し な 
いと いう 方 針 に する こと で す 。 艦 こ れ の 場合 、 OS と その バー ジョ ン 、 ブ ラウ ザ と その バー ジョ ン *、 flash プ レイ ヤー の 製 
造 元 と バー ジョ ン を 指定 し て 許可 すれ ば よい で し ょ う 。 も ちろ ん これ は クソ 不 自由 で Web の 世界 の 理念 に 反する こと は 明 
ら か で すし 、 と りあ え ず Opera ユ ー ザ が 発狂 する 姿 が あり あり と 目 に 浮か び ま す ?。 


ロ 


. 出撃 中 の 操作 は た し か 冬 イ ベン ト あ た り に 大 幅 に 修正 され て 今 は も う で き な い ” 


に ) 


. そ ん な 恐ろし いこ と や っ た こと あり ませ ん っ の 


の / 


. 昔 か ら ほ と ん どの ソフ トウ ェ ア の 契約 条項 に 逆 ア セ 禁 止 が 含ま れ て いる ” 


FN 


. chrome 拡 張 で 同じ こと を する まで で す 拡張 が 入っ た chrome で の プレ イ は 禁止 する っ て !? ハハ 、 こ や つめ ! の 


| 


.Linux ユ ー ザ が 発狂 する 姿 も 見 えま すね ・・・ ぐ の 


出撃 ・ 戦 闘 

この 章 で は ゲー ム の 華 で ある 戦闘 の API を 解説 し ます 。 
出撃 ・ 戦 闘 の 流れ 
戦闘 に 関 係 する API は 


e 移動 系 API 
e 戦闘 系 API 
e 結果 系 API 


の 3 種類 に 分 類 で きま す 。 これ を 繰り 返し て 戦 閣 し ます 。 


移動 系 API 


出撃 する マッ プ を 選ん だ 時 の 「 出 撃 APIl」 と 、 戦 闘 後に 進軍 を 選ん だ 時 の 「 進 軍 API」 が な ぜ か 同じ レス ポン ス で す 。 羅 針 
盤 が 回 っ て いる 時 に は 既に 行き 先 は 決定 し て いま す 。 


レス ポン ス に は 移動 先 の 情報 が 含ま れ て いま す が 、 本 当 に 知性 を 感じ られ な い 設 計 に な っ て いま す 。 特に 重要 な 戦闘 の 属 
性 は api_cotor no と いう 意味 の 分 か ら な い キ ー 名 が 振ら れ て いま す 。 夜戦 スタ ー ト と か は 判明 し た ん で す が 潜 水 艦 の 判 
定 を 出し て る の が どこ な の か は 最後 まで 判明 し ませ ん で し た 。 


あと 物資 が も ら え る マス を 通っ て も 物資 が 増え な いと いう 現象 に 遭遇 し まし た 。 これ も 最後 まで 何 を すれ ば 回 収 で きる の 
か 判明 し ませ ん で し た 1。 


戦闘 系 API 


移動 先 の 戦闘 属性 に 従っ て 適切 な 戦闘 API を 叩く 必要 が あり ます 。 戦闘 API は 「 通 常 戦闘 」「 夜 間 戦 闘 」「 夜 か ら 昼 」 の 3 
種類 が あり ます 。 「 通 常 戦闘 か ら の 夜戦 」 と 「 夜 間 戦闘 」 は 別 の API で す 。 


戦闘 API を 叩く と 戦闘 結果 が 返っ て きま す 。 信じ が た い ほ ど 理 解 し に くい JSON で 、 知 性 の 欠如 を 感じ ます 。 


例え ば 砲撃 の 結果 は 、 api_hougeki の 中 に api_def_1ist と api_damage の 2 つの 配列 が 入っ て いま す 。 


{ 
"ap1_hougek1i": { 
UE ltGiRg lO SB 中 ml 
"ap1_damade": BS SU aa し 


この デー タ を 、 api_def_list の n 番目 に 書か れ た 艦 ? に api_gamage の n 番目 に 書か れ た 数 字 を ダメ ー ジ と し て 与え 
る 、 と いう ルー ル で 処理 し て いき ます 。 


api_hougeki を 配列 に 、 そ の 中 の 要素 を ハッ シュ に し た ほう が 圧倒 的 に 理解 し や すい 表現 で す 。 


(6 
"ap1_hougek1": [ 
{"attacker": 1, "defender": 19, "damage": 251, 
"attacker": 11。 "defender": 3, "damage": 31, 
{"attacker": 4, "defender": 12, "damage": 15}, 
{"attacker": 12, "defender": 1, "damade": -11, 


サイ ズ が 気 に な る な ら 、 可読性 は 落ち ます が ハッ シュ で は な く 配 列 に し て も いい で し ょ う 。 


56 
"ap1_hougek1": [ 
の H9 油 25 
| 
SE53 
2 陳 el 
] 
+ 


この 場合 コー ド に よる 補足 が 無い と 理解 し づら いで す が 、 api_hougeki が 配列 な だ け で 人 病 か に マシ で す 。 API レ スポ ンス 
は 人 間 の 理解 で きる 構造 を 表現 する べき で あり 、 元 の レス ポン ス は for 文 と いう コン ピュ ー タ の 処理 の 都合 に 合わ せ て 
作ら れ て いて 不適 切 で す *。 


な お 、 去 年 の 冬 く らい に 、 「 戦 闘 APDI を 叩い た あと は 10 秒 間 待 た な いと 次 の API リ クエ スト が こと ご と く エ ラー に な る 」 


よう に 仕様 変更 され まし た 。 この 変更 に より 、 た だ で さえ 面倒 な 戦闘 が 致命 的 に 面倒 に な っ た の で 、 イベ ント 以外 の プレ 
イ を 完全 に 辞め まし た 。 


結果 系 API 


結果 API を 叩く と その マス で の 戦闘 が 終了 し ます 。 夜戦 に 行か な い 場 合 も 結果 API を 叩き ます 。 レス ポン ス は 関心 が な い 
の で 調べ て ませ ん が 、 経 験 値 と か ドロ ッ プ と か が 書か れ て いる ん だ と 思い ます 。 


マッ プ の 終端 に 到達 し た 場合 や 進撃 せ ず に 撤退 する 場合 は 、 母 港 画 面 に 戻り 、 艦 隊 情 報 の 取得 な どの 一 連 API が 叩か れ ま 
す 。 この 一 連 の API の 中 に ある /kcsapi/api_auth_member/1ogincheck と いう API が 、 実は 出撃 状態 だ っ た ら 出 撃 を 完了 する 


と いう 処理 を し て いま す 。 まっ た く 名 が 体 を 表し て いな いし 、 ユ ー ザ か らし た ら 完 全 に 副作用 で す 。 い みわ か ん な い 。 出 
撃 中 に 猫 っ た 場合 、 再 ログ イン させ られ て れ て 母港 に 飛ぶ の で 出撃 状態 が 解除 され ます 。 


問題 点 


戦闘 の 流れ は と に か く 理 解 し に くい で す 。 完全 に 場当たり 的 な 実装 を 繰り 返し て いる の が 想像 で きま す 。 レス ポン ス も 整 
理 さ れ て お ら ず 、 違 う API な の に 同じ よう な レス ポン ス を 返し て いた り し ます 。 出撃 と いう 行動 の モデ リン グ が で き て な 
いと 思わ れ ま す 。 


REST と いう 考え 方 


REST で は 、 物 事 を リソー ス と し て URL で 表現 し 、HTTP メ ソ ッ ド を 正しく 使っ て その リソー ス を 操作 し ます 。 REST と 
API は 相性 が よく 、 よ い 設 計 の 助け に な り ま す 。 


RESTful 戦 闘 API 設 計 サ ンプ ル 


出撃 - 戦 闘 - 結 果 の 一 連 の API を RESTful に し て み ま し ょ う 。 戦闘 に 限ら ず ゲ ー ム は リソー ス 作 成 / 操 作 の 積み 重ね で す 。 全 
て の リソー ス を 頭 か ら 再 評価 すれ ば 最後 の 状態 を 復元 で きる よう に し ます 。 


出撃 
まず 1 つ 目 の リソー ス は 出撃 で す 。 英語 だ と sotie で す 。 ます 出撃 する に は posr メソ ッ ド で 新しい sotis の リソー ス を 
作成 し ます 。 map_iq や fleet id な ど が パラ メー タ に な る で し ょ う 。 


POST /soties 


レス ポン ス は この よう に な り ま す 。 


TOM< 還 23 人 91234 | 
EeeE 当 id 
"area_1d": 3, 
iiElosie MR と 

"done": fa1se 


すでに 出撃 中 の 場合 ?、API は 4ge sad Request を 返し て 失敗 し ます 。 


この 出撃 の リソー ス に は 何時 で も 、 何 回 で も アク セス で き 、 常 に 同じ 情報 が 取得 で きま す 5。 


GET /soties/2341234 


出撃 を 終了 する に は pELErE メソ ッ ド を 使い ます 。 


DELETE /soties/2341234 


リク エス ト を 見 る だ け で done が true に 設定 され る と 想像 で きる で し ょ う ?。 


移動 


移動 も リソー ス と 考え て 良い と 思い ます 。 リソー ス 名 は move で す 。 リソー ス は 名 詞 と いう ルー ル が ある の で 、 動 詞 の 
move で は な く 名 詞 の move で ある こと を 忘れ て は いけ ませ ん 。 posr メソ ッ ド で 移動 を 作成 し ます 。 


POST /soties/2341234/moves 


移動 で きる 場合 は 、 移 動 先 の 情報 と 次 に すけ べき こと を 示し た デー タ が 取得 で きま す 。 


例え ば 戦闘 が 必要 な マス に 移動 し た 場合 は この よう な 感じ で し ょ うか 。 


t 
リ 1d": 98765, 
olMMail 
"type": "Datt1e", 
"submarine": true, 
"boss": fa1se, 
"next" "batt1e" 

i 


みん な 大 好き 物資 マス は こん な 感じ で すね 。 


id": 98766, 

Ge(NIM05302 

"type"i "Supp1y", 

"items": { 
"stee1": 15, 
feB0: 地 5 

月 


"next": "move" 


移動 で き な い 場合 『 は 、 4ge gaq Request を 返し ます 。 


いと 思い ます 。 


レス ポン ス の 中 身 に 戦闘 し ろ 、 と か 帰還 し ろ 、 の よう に 書い て も い 


も ちろ ん 作っ た リソー ス は egEr で 何 度 で も 情報 は 取得 で きる し 、 更に 全て の 移動 経路 も 取得 で きる API も 欲し いで すね 。 


GET /soties/2341234/moves/98765 
GET /soties/2341234/moves 


戦闘 と 結果 


戦闘 する と きも 、 ま ず posTr メソ ッ ド で battle を 作り ます 。 


POST /soties/2341234/batt1es 


元 の API だ と 通常 戦闘 な の か 、 夜 戦 な の か 、 な ど に よっ て 呼び 出す API が 違い まし た が 、 戦闘 と いう リソー ス は 一 つの は ず 
な の で 分 ける べき で は あり ませ ん 。 


この よう な レス ポン ス を 返し まし ょ う 。 


YOUU: 還 132435: 
"type": "norma1" 


} 


と りあ え ず 戦闘 の リソー ス を 作り まし た 。 この と りあ え ず と いう の が 重要 で す 。 サー バ は 現在 の 状態 を 知っ て いる の 
で 、 sotie_id と ce11 が 自動 で 記録 され ます 。 API レ スポ ンス に 載せ る か どう か は 別 の 話 で す 。 


通常 戦闘 の 場合 、 陣 形 を 選択 し ます 。 これ は 、 作 っ た 戦闘 の リソー ス の 陣形 を 変更 する と 考え ます 。 存在 する リソー ス へ ヘ へ 
の 変更 は pur を 使い ます 。 


PUT /soties/2341234/batt1es/132435 


format1on=3 


これ は 何 度 で も 実行 で きる べき で す 。 また 、 変 更 で き な い 場合 ? は 、 4ge Bad Request を 返し て も いい し 、 ze success 
を 返し つつ 変更 は 無視 し て も いい で し ょ う 。 


戦闘 結果 を 取得 し まし ょ う 。 
GET /soties/2341234/Datt1es/132435/resu1t 


も ちろ ん er な の で 何 度 叩 いて も 良い し 、 常 に 同じ 結果 を 返し ます 。 最初 に リク エス ト さ れ た 時 に 戦闘 の 計算 を 行い 、 
戦闘 結果 を 確定 し 、 デ ー タ ベー ス 等 に 記録 し ます 。 艦隊 へ の ダメ ー ジ や 、 燃 料 砲弾 の 減算 の 反映 な ども 行い ます 。 内 部 的 
に 持っ て いる 昼 戦 確定 フラ グ の よう な も の も 立て て お きま す 。 いっ た ん 昼 戦 確定 フラ グ が 立っ た ら 、 陣 形 の 変更 は 二度と 
で き な い よう に し な けれ ば な り ま せん 。 2 度目 以降 の アク セス は 、 デ ー タ ベー ス 等 に 記録 され た 内 容 を 返し ます 。 
通常 戦闘 は この あと 夜戦 に 行く こと が で きま す 。 や は りこ れ も 戦 闘 リ ソース を 変更 する と 考え ます 。 

PUT /soties/2341234/batt1es/132435 


night_batt1e=true 


夜戦 し た 場合 の 戦闘 結果 も 同様 で す 。 


GET /soties/2341234/batt1es/132435/resu1t 


夜戦 結果 が 無かっ た ら 計算 を 行い 、 記 録 し 、 結 果 を 返し ます 。 戦闘 リリ ソリ ー ス と し て は 1 つ な の で 、 昼 戦 の 結果 に 更に 夜戦 
の 結果 が 追加 され た よう な 形 に な り ま す 。 夜戦 だ け の 結果 を 返す の は 間違っ て いま す 。 も ちろ ん 夜戦 確定 フラ グ の よう な 
も の を 立て て お きま す 。 も う night_batt1e=falss に する こと は で きま せん 。 


戦闘 が 終わ っ た ら 経 験 値 と 艦 娘 ゲ ッ ト の 時 間 で す 。 pur で 終了 を 伝え まし ょ う 。 


PUT /soties/2341234/batt1es/132435 
complete=true 


その 後 
GET /soties/2341234/batt1es/132435/resu1t 


を 叩く と 、 経 験 値 や ドロ ッ プ が 追加 され た 戦闘 結果 が 取得 で きま す 。 


ゲー ム で は 順 々 に 処理 され て いく の で 無理 で す が 、API で は この よう に リク エス ト す る こと も 可能 で す 。 


PUT /soties/2341234/batt1es/132435 


format1ion=3&n1ght_batt1e=fa]se&comp1ete=true 


これ で result を 叩け ば 一 発 で 結果 が 取得 で きま す 。 


コン ピュ ー タ の 都合 で JSON の 構造 を 決め る の も 間違っ て いま す が 、 ゲー ム の 都合 で API を 実装 する の も 間違っ た こと で 
す 。 


状態 の 復旧 


現在 の API で は 、 何 か エラ ー が ある と すぐ に 猫 画 面 を 出し 、、 と に か く リ ロー ド さ せ 、 全 て を 諦め て 母港 に 飛ば し ます 。 こ 
の 仕様 は 本 物 の 糞 で す 。 


最後 に どの 状態 だ っ た の か 、 サ ー バ は 知っ て いる は ず で す 。 きち ん と 設計 すれ ば 直前 の 状況 まで 復旧 する こと は 可能 で 
す 。 今回 の 実装 例 だ と 、 過 去 も 含め て 全て の 出撃 を 再現 可能 で す 芽 。 


この 点 パ ズ ド ラ は 本 当 に 上 手 く や っ て いる と 思い ます 。 


問題 点 


た ぶん この 戦闘 API の 設計 に は 色々 反論 し た い 人 が いる と 思い ます 。 夜戦 は 新しい リソー ス と し て 作る べき だ と か 、 そ れ 
ぞ れ の result 分 ける べき だ と か 、 Posr /batt1es の 瞬間 に 結果 を 確定 させ る べき だ と か 、 ま ぁ い ろ い ろ 思 うと ころ は ある と 
思い ます 。 これ も た だ の 一 例 な の で 、 よ く 考 えて 作ろ うと か 俺 は こん な ふう に 思考 し て 作っ て る っ て 部 分 が 伝われ ば いい 
と 思い ます *?。 


この API 設 計 の 問題 点 と し て 、 明 ら か に 更新 の 処理 が 複雑 に な る の が 目 に 見 えて いま す 。 どの パラ メー タ を 弄 れ る か と い 
う の が か な り 状 態 に 依存 する の で 、 さら に 内 部 を 綺麗 に 設計 し な いと 巨大 な if 文 の 聞 に な る で し ょ う 。 た だ し 他 の 部 
分 に 聞 が な く な る の で 、 この よう な 闇 を 一 箇所 に 押し 込め た 設計 は 完全 な 悪 で は 無い と 思い ます 。 


まとめ : API 改 善 ガ イド 


e リク エス ト と レス ポン ス を 1 対 1 対応 させ る 

e JSON は 処理 の 都合 で は な く あ る べき 構造 に 合わ せる 
e リソー ス の 概念 を 理解 し API を 整理 する 

e 状態 で の 分 岐 を 減ら す 


根本 的 な 問題 は 、 度 重なる 仕様 変更 で どん どん 戦闘 シス テム が 複雑 に な っ て いる こと で す 。 その 対応 と し て 場当たり 的 な 
拡張 を 続け 、 は っ きり 言っ て シス テム は 破綻 し て いま す 。 艦 こ れ が 圧倒 的 に つま ら な い 原 因 は この 複雑 な 戦闘 シス テム で 
29 


外 か ら 見 た だ け で は 分 か ら な い の で ここ で は 触れ て いま せん が 、 実際 の 戦闘 の 処理 も 相当 複雑 な コー ド に な っ て いる と 思 
いま す 。 特に イベ ント ボス の 弱点 に 特定 の 装備 を 設定 し て いる と ころ な ど 、 API 設 計 の 能力 を 見 る 感じ で は た ぶん 相当 複 
雑 で カオ ス な コー ド に な っ て いる ん じゃ な いで し ょ うか 。 あと 3 回 くら い イ ベン ト を や っ た 後 く らい に は 、 戦闘 の 処理 を 
する 関数 を 含む ファ イル は 社内 で 『 聖 典 』 な ど と 呼ば れる よう に な る と 予測 し ます 。 そう な る と も う 手 が 付け られ ず 、 誰 
も 変更 の 影響 範囲 を 正しく 把握 で きず 、 少し の 変更 で も バグ が 出 て 実装 に 何 週間 も か か る よう な 状態 に な り ま す 。 


まず は と に か く ゲ ー ム シス テム の 単純 さ を 取 り 戻 すこ と が 何より 重要 だ と 思い ます 。 


1 オリ ョ クル ? な に それ 美味 し い の ? ご 


) 


. 誰が 攻撃 し た か は 戦闘 結果 に 関係 な い の で 無視 し て いる 


1 の) 


. 敵 味方 艦 混合 で イン デック ス が 振ら れる 味方 艦 :1-6 敵艦 :7-12 みた いな 感じ に ” 


2. 元 レ スポ ンス の 配列 は 固定 長 つま り 固 定 回 数 の ror を 回 し て いる 可能 性 が ある 圧倒 的 に ダサ い 


9 


. つ まり done が false な sotie が 存在 する 場合 っ 


oy 


. こ の よう な 性 質 を 寺 等 性 と 言う HTTP の eEr は 吉 等 性 を 持つ べき と され て いる の 


FI 


. こ の 方 法 を 論理 削除 と いう 記録 を 残す 必要 が な けれ ば 単に 物理 削除 し て も よい ” 


Oo 


. 戦闘 し な いと いけ な い 場 合 や 終端 の 場合 な ど っ 


〇 


. 少数 編成 の 場合 や 通常 戦 閣 で な い 場 合 
7. 現状 で も 可能 だ と 思う ん で すけ ど ね ・・・ 出 撃 終了 条件 を 変 な 扱い し て る か ら ・・・ の 
. 出撃 時 の 艦隊 の 状態 を 保存 する 必要 が あり ます 


12 こわ いこ わい RESTful お じ さ ん に 見 つか り ま せん よう に ・・・ で 


まとめ 


API 設 計 に 大 事 な こ と の まとめ で す 。 
セキ ュ リ ティ 


あり と あら ゆる 攻撃 を 考慮 し な いと いけ ませ ん 。 


ユー ザ の 環境 も 様々 で す 。 API を 提供 する 側 は それ ら を 制限 する こと な ん て で きま せん 。 クラ イア ント に 正しい も 間違っ 
て いる も あり ませ ん 。 不正 な 攻撃 で あろ うと 全て の リク エス ト は 平等 に 扱わ れ て し まう こと を 忘れ て は いけ ませ ん 。 


と に か く 想 像 力 が 必要 で す 。 人 間 は 全員 犯罪 者 で 、 あ り と あら ゆる 手段 を 使っ て 攻撃 を し て きま す 。 どん な 攻撃 が で き そ 
うか 想像 し 続け まし ょ う 。 単純 に シス テム 上 の や り と り だ け で は あり ませ ん 。 ソー シャ ル ハ ッ ク も か な り 有 効 な 攻撃 手段 
で す 。 (ハッ カー に 奪わ れ た 、5 万 ドル の Twitter ア カウ ント 「@N」: オ ー ナ ー に 返 本 見 事 な ソ ー シ ャ ル ハ ッ ク 事 例 ) 他 の 
サー ビス の 情報 と 組み 合わ せ た 攻 撃 1 も 有効 で す 。 本 当 に 穴 は な いで すか ? XSS の よう に 機械 的 に 検出 で きる よう な も の で 
は あり ませ ん 。 複雑 な と ステム の 一 つ ー つ は 小さ な 穴 で も 、 組 み 合 わせ た ら 大 き な 穴 に な る こと も あり ます 。 本 当 に 穴 は 
な いで すか ? 


と りあ え ず API の 提供 は 必ず HTTPS を 使い まし ょ う 。 経路 上 で お こる ほとん どの 攻撃 は これ で 防げ ます <。 今どき は API だ 
け で な く 全 て の Web ア クセ ス を HTTPS に する べき で す 。 Google 大 先生 に 信 い まし ょ う 。 


API レ スポ ンス の 内 容 に は 十分 注意 を は らい まし ょ う 。 余計 な 情報 か ら 実 装 が 透け て 見 える 場合 が あり ます 。 他人 が 知っ 
て は いけ な い 情 報 を 絶対 に 流し て は いけ ませ ん 。 その 情報 を 他人 が 知っ た 場合 どの よう な 攻撃 に 使え る か * 設 者 し て 、 必 
要 な 情報 の み を 選び まし ょ う 。 「 自 分 の じゃ な い 場 合 の 個人 情報 は クラ イア ント アプ リ で 無視 する 」 み た いな 実装 を 提案 
し て くる バカ が いま す 。 死ね ば いい と 思い ます 。 


そし て 何より 、 不 要 な 個人 情報 を 和 ろ うと し な い の が も っ と も 効果 的 で す 。 OAuth を 使え ば パス ワー ド な ん か 知る 必要 は 
あり ませ ん 。 パス ワー ド が な けれ ば リス ト 型 攻撃 も 怖く あり ませ ん 。 住所 や 電話 番号 を 知る 必要 が ある サー ビス な ん て ご 
く 一 部 で す 。 知る 必要 の な い 情 報 は 知る べき で は な い 、 と いう スタ ンス を 貫く と 身軽 に な り ま す 。 


===[column] ソー シャ ル ハ ッ ク 秘密 な よう に 見 えて パブ リッ ク な 情報 は た くさ ん あり ます 。 例え ば 、 秘 密 の 質問 に よく あ 
り が ちな 「 母 親 の 旧姓 は ?」 な ん て 家族 や 親戚 に は ノー ガー ド で す 。 も ちろ ん 家族 や 親戚 も 犯罪 者 で ある こと を 忘れ て は 
いけ ませ ん 。 田舎 の 場合 近所 の ほとん どの 人 が 知っ て いる こと も ある で し ょ う 。 「 通 っ て いた 小学 校 の 名 前 は ?」 も 全然 
秘密 じゃ な いで す 。Facebook に 書い て あり ます 。 「 飼 っ て る ペッ ト の 名 前 」 は 積極 的 に 出し て いっ て ます よね 。 「2 段 階 
認証 で 誕生 日 を た 入力 し て くだ さい 」 な ん て 完全 に ZAL で すね ぇ 。 


人 間 は 生き て いる だ け で 大 量 の 情報 を 垂れ 流し て いま す 。 垂れ 流し た ほう が Web は 面白 い の で 積極 的 に 垂れ 流し た ほう が 


いい と 思い ます 。 個人 に 本 物 の 秘密 な ど 無い と セキ ュ リ ティ 設計 者 は 考え た ほう が いい で し ょ う 。 いろ いろ な 公然 の 秘密 
と 、 サ ポー ト の よう な 人 間 相 手 の 交渉 が 組み 合わ さる と 、 シス テム の セキ ュ リ ティ は 意外 な ほど 脆く 崩れ 去り ます 。 


RESTful 


世の中 猫 も 析 子 も RESTful な の で RESTful に し まし ょ う 。 この 業界 、 長 いも の に 巻 か れる の は 大 正義 で す 。 


モノ を リソー ス と し て 捉え 、 そ の 操作 を HTTP メ ソ ッ ド に 割り 当て ます 。 制約 を 与え る こと で 設計 に 統一 感 が 出 て 、 表 現 
力 が 高まり ます 。 当然 で す が HTTP メ ソ ッ ド を 正しく 使い まし ょ う 。 GET は 必ず 吉 等 性 を 保証 し な けれ ば いけ ませ ん 。 


HTTP ス テー タス コー ド も 正しく 使い まし ょ う 。 失敗 し て いる の に zee で 返し て は いけ ませ ん 。 JSON の 中 の success 
で 判断 し ろ な ん て API は クソ で す 。 


最初 は リソー ス の 設計 も 難し いで し ょ う 。 と こと ん 考え 、 議 諭す る こと が 重要 で す 。 仕事 で は 1 つの URI を 決め る の に 3 日 
議論 し た こと も あり ます 。 それ だ け 名 前 を つけ る と いう の は 重要 な 行為 で す 。 


つい で に 認証 の 方 法 は OAuth に し まし ょ う 。 艦 こ れ の 場合 、OAuth + 余計 な 検証 に な っ て いま す 。 意味 の な い 検 証 を や め 


て 素直 な API ア クセ ス が 可能 で ある べき で す 。 リフ ァ ラ 検証 な ど は や っ て は いけ ませ ん 。 gzip が 使え な い ク ライ アン ト に 
も きち ん と 対応 し まし ょ う 。 世の中 の すべ て の ブラ ウザ を 把握 する な ん て 無理 で す 。 


JSON 


大 前 提 と し て 、API レ スポ ンス と し て の JSON は 人 間 が 読む も の で す 。 人 間 が も っ と も 理解 し や すい デー タ 構 造 に する べき 
で す 。 ば っ と 見 た だ け で 意味 が わか る 構造 に な か っ て ます か 2 コン ピュ ー タ で の 処理 を 先 に 考え て デー タ 構 造 を 作る と だ い 
た い 間 違っ た こと に な り ま す 。 世界 を 正しく 認識 し デー タ 構 造 を モデ リン グ し まし ょ う 。 


すべ て の キー 名 を 熟考 し まし ょ う 。 全く 初見 で も 意味 が 理解 で きる キー 名 に な っ て ます か ? きち ん と し た 英 単 語 を 使い ま 
し ょ う 。 絶対 に 単語 を 省略 し て は いけ ませ ん 。 複数 の も の な らき ちん と 複数 形 を 、 状態 を 表す 場合 は 形容 詞 が ふさ わし 
いか それ と も 過去 分 詞 か * よ く 考 えま し ょ う 。 英語 力 は か な り 必 要 で す 。 と いう か エン ジニ ア に 一 番 必 要 な も の は 間違い 
な く 英 語 力 な の で 英語 の 勉強 は 必ず し まし ょ う 。 


た だ デー タ サ イズ が 大 きく な りす ぎる と 、 通 信 コ スト と し て ジワ ジワ 効い て きま す 。 可読性 と 通信 コス ト は トレ ー ド オフ 
な 部 分 も ある の で ?、 本 当 に 必要 で あれ ば サイ ズ に 最適 化す る 場合 も あり ます 。 


まとめ の まとめ 


3 つ に 共通 する こと は と に か く 考 える こと で す 。 最近 は 言語 や フレ ー ム ワー ク の 発達 で 実装 に 掛か る 時 間 は 大 きく 短縮 し 
て いま す 。 その 分 と こと ん 深く 長く 考え る こと が で きま す 5。 


機能 が 正しく 動く の は 当たり 前 の こと で す 。 今 の 時 代 、 動 け ば 良い な ん て 考え は 通用 し ませ ん 。 理解 し や すい か 、 保 守 し 


や すい か 、 拡 張 し や すい か 、 ひっ くる め て 如何 に よい 設計 か 、 と いう と ころ が 求め られ ます 。 どれ だ け ア タマ と 時 間 を 
使っ た か が API 設 計 の 良し 悪し が 決ま り ま す 。 考え 尽く し て 正しい 設計 を 導き 出す の が エン ジニ ア の 最大 の 使命 で す 。 


コス ト 


最後 に すべ て の 判断 基準 と な る コス ト の 話 で す 。 シス テム の コス ト 源 は 
人 間 > ネッ トワ ー ク > ( 壁 ) > スト レー ジ > (超え られ な い 壁 ) > CPU 


で ある こと を 忘れ て は いけ ませ ん 。 今 は 無限 に サー バ が 増やせ る 時 代 な の で 、 サ ー バ を 増やせ ば 済む こと は サー バ を 増 や 
すべ き で す 。 スト レー ジ も ちょ っ と 高い けど 無限 で す 。 それ に 比べ て ネッ トワ ー ク 帯域 は 料金 も 高く 、 な に より 通信 速度 
に 限界 7 が あり 、 大 き な デ ー タ を 送受 信 す る こと は ユー ザ 環 境 に 依存 する スト レス 源 で も あり ます 。 


人 間 は 最大 の コス ト 源 で す が 、 こ こ を ケチ る と 糞 シ ステ ム に な り 最 終 的 な コス ト が 増大 し ます 。 高 コ スト で ある と 同時 
に 、 最 も 価値 を 発揮 する 装置 で す 。 人 間 は コン ピュ ー タ に は で き な い 仕事 を し な いと いけ ませ ん 。 設計 な どの 考え る 仕事 
が それ で す 。 実際 に コー ド を 実装 する 部 分 も 、 未 だ に 機械 は 完全 に は 『 こ な し て くれ ませ ん 。 良い 設計 か ら 良 い 実装 を す 
る の も や は り ま だ 人 間 で な く て は で き な い 仕事 で す 。 


人 間 が や る べき 仕事 を エン ジニ ア が 最高 の パフ ォ ー マ ンス で で きる と いう こと を 最 優先 し まし ょ う 。 
1+. 他 の サー ビス か ら 流 出し た パス ワー ド で 不正 アク セス する 最近 大 人 気 の リ スト 型 攻撃 
2 HeartBleed..… う ッ 頭 が ッ 


3. 最近 の 小学 生 は 登 下校 中 は 名 札 を 外す よう 教え られ る 名 前 を 知ら れ た 場合 どの よう な 攻撃 を 受け る か 考え て みよ 


ドー 


\/ 


4 俺 も よく わか っ て な い 


5. 計算 の 処理 コス ト は 比較 に な ら な い ほ ど 小 さい 


2. も し 今 で も 実装 に 手 一 杯 と いう な ら 言 語 や フレ ー ム ワー ク の 選択 が 間違っ て いる の か も し く は 才能 が な い の で エ 
ンジ ニア 辞め た ほう が いい で す 


7. 一 般 的 な 家庭 向け 回 線 速度 は 10 年 前 と 比較 し て も 理論 値 で 2 倍 程度 に し か な っ て いな い の 


9 フレ ー ム ワー ク は ずい ぶん 発達 し 大 規模 な コー ド の 自動 生成 を 行う が 完全 な 全 自動 化 は まだ まだ 先 の 話 だ ろう 


あと が き 


前 回 は 落選 だ っ た の で 1 年 ぶり の サー クル 参加 で す 。 いか が だ っ た で し ょ うか 。 冬 コ ミ 時 期 は twitter 絶 賛 大 炎上 中 だ っ た 
の で 、 ま あ 落 ち て よかっ た の か も 。 


今回 の 本 に つい て 


今回 の 本 も 面倒 な 人 に 見 つか っ た ら 炎 上 の 可能 性 高い で すね 。 今 ま で 作っ た 本 の 中 で 一 番 攻 め て いる 感じ だ と 思い ます 。 
今 ま で ぬる ぬる や っ て いた の に 一 転 攻勢 で す 。 健全 な 人 生 を 送っ て きた 自称 良識 派 の 人 は 表紙 を 見 た だ け で 全力 で 非難 し 
て くる で し ょ う ね 。 


と は いえ 、 こ の 本 の きっ か け は 「 俺 だ っ た ら 艦 これ の クソ API を どう 直す か 」 と いう 話 で あり 、 こう いう クズ な API を 実装 
し て し まう 人 を 1 人 で も 減ら すこ と を 目的 に し て いま す 。 API の 具体 的 な 内 容 を 深く 解説 し な か っ た の は こう いう 理由 な の 
で す 。 至っ て 真面目 で 非常 に 教育 的 で あり 健全 で すね 。 


この 本 を 書き な が ら 技 術 的 な 検証 を し て いる 際 に 、 本 当 に 踏ん で は いけ な い 脆 弱 性 を 見 つけ て し まい 、 ゴ ニョ ゴ ニ ョ ゴ 
ニョ し まし た 。 本 当 に 冷や 汗 出 まし た 。 今 は まだ 話せ な い の で いずれ 話せ る 機会 が あっ た ら 笑 い 話 に し た いで す 。 


Re:VIEW 


今回 の 執筆 フォ ー マ ッ ト は Re:VIEW を 使っ て み ま し た 。 実際 に は md2review を 使っ て Markdown か ら Re:VIEW に 変換 し て 
ます 。 基本 は Markdown の 文法 で 書い て 、 Re:VIEW 特 有 の タグ は その まま Markdown に 書く と 問題 な く 変換 で き て も の す 
ご く 便 利 で す 。 


た だ 自由 度 は だ いぶ 低く 未 実装 な 機能 も 多い よう な の で 苦労 し ます 。 原稿 部 分 は 楽 な ん だ けど あと が き と 奥 付 を 追加 する 
の に 非常 に 苦労 し まし た 。 と いう か 今 か ら Re:VIEW の コー ド を 弄っ て 欲し い ア ウト プッ ト を 実装 し ます ・・・ 


っ と 上 の 文章 を 書い て か ら 2 時 間 ほ ど Re:VIEW の コー ド と 格闘 し て いた ん で す が 、 な ん で すか この クソ コー ド は ・・・ こ 
れ は マジ で ちょ っ と ビビ る レベ ル の クソ コー ド で す よ 。 夏 コミ が 無事 に 終わ っ た ら 冬 に 向け て Re:VIEW に プル リク 送り ま 
くる し か な いと 思い まし た 。 


今後 に つい て 


そろ そろ 別 の こと も し て みた いな ぁ と 思っ て みる けど コー ド 書 く 以 外 何 も で き ね えん だ な ぁ 俺 。 そろ そろ Crash of Clans 
の スト レス が 高く て 自動 化し た いと 思っ て いる の で 、 上 手 く いけ た ら そ の ネタ や る か も し れ ま せん 。 あと 久しぶり に エロ 
漫画 の 原作 書き た いで す 。 


